<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Chapter 16. プラグインによる Smarty の拡張</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
<link rel="home" href="index.html" title="Smarty マニュアル">
<link rel="up" href="smarty.for.programmers.html" title="Part III. プログラマのための Smarty">
<link rel="prev" href="template.resources.html" title="テンプレートリソース">
<link rel="next" href="plugins.naming.conventions.html" title="命名規約">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">Chapter 16. プラグインによる Smarty の拡張</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="template.resources.html">Prev</a> </td>
<th width="60%" align="center">Part III. プログラマのための Smarty</th>
<td width="20%" align="right"> <a accesskey="n" href="plugins.naming.conventions.html">Next</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="chapter" title="Chapter 16. プラグインによる Smarty の拡張">
<div class="titlepage"><div><div><h2 class="title">
<a name="plugins"></a>Chapter 16. プラグインによる Smarty の拡張</h2></div></div></div>
<div class="toc">
<p><b>Table of Contents</b></p>
<dl>
<dt><span class="sect1"><a href="plugins.html#plugins.howto">プラグインの動作原理</a></span></dt>
<dt><span class="sect1"><a href="plugins.naming.conventions.html">命名規約</a></span></dt>
<dt><span class="sect1"><a href="plugins.writing.html">プラグインの記述</a></span></dt>
<dt><span class="sect1"><a href="plugins.functions.html">テンプレート関数プラグイン</a></span></dt>
<dt><span class="sect1"><a href="plugins.modifiers.html">修飾子プラグイン</a></span></dt>
<dt><span class="sect1"><a href="plugins.block.functions.html">ブロック関数プラグイン</a></span></dt>
<dt><span class="sect1"><a href="plugins.compiler.functions.html">コンパイラ関数プラグイン</a></span></dt>
<dt><span class="sect1"><a href="plugins.prefilters.postfilters.html">プリフィルタ/ポストフィルタプラグイン</a></span></dt>
<dt><span class="sect1"><a href="plugins.outputfilters.html">アウトプットフィルタプラグイン</a></span></dt>
<dt><span class="sect1"><a href="plugins.resources.html">リソースプラグイン</a></span></dt>
<dt><span class="sect1"><a href="plugins.inserts.html">インサートプラグイン</a></span></dt>
</dl>
</div>
<p>
   Smarty 2.0 から導入されたプラグインアーキテクチャにより、
   Smarty のほとんど全ての機能がカスタマイズ可能になりました。
   プラグインには次のものがあります。
   </p>
<div class="itemizedlist"><ul class="itemizedlist" type="disc" compact>
<li class="listitem">テンプレート関数プラグイン</li>
<li class="listitem">修飾子プラグイン</li>
<li class="listitem">ブロック関数プラグイン</li>
<li class="listitem">コンパイラ関数プラグイン</li>
<li class="listitem">プリフィルタプラグイン</li>
<li class="listitem">ポストフィルタプラグイン</li>
<li class="listitem">アウトプットフィルタプラグイン</li>
<li class="listitem">リソースプラグイン</li>
<li class="listitem">インサートプラグイン</li>
</ul></div>
<p>
   リソースを除いて、register_* API
   によって関数を登録する古い方法の後方互換性はサポートされます。 
   API を使わずに、代わりに <code class="literal">$custom_funcs</code>,
   <code class="literal">$custom_mods</code> や その他のクラス変数を変更していたなら、
   API を使用するか、行った拡張をプラグインに変換するようにスクリプトを調整する必要があります。
  </p>
<div class="sect1" title="プラグインの動作原理">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="plugins.howto"></a>プラグインの動作原理</h2></div></div></div>
<p>
    プラグインは要求があると常に読み込まれます。テンプレートから呼び出された
    修飾子・関数・リソース等のプラグインだけが読み込まれます。
    さらに各プラグインは同じリクエスト内に Smarty
    の異なるインスタンスが複数実行されていても、読み込まれるのは一度だけです。
   </p>
<p>
    プリフィルタ/ポストフィルタとアウトプットフィルタは少し特殊です。
    これらはテンプレートから呼び出されないので、テンプレートが処理される前に
    API 関数を経由して明示的に登録または読み込まれる必要があります。
    同じ種類の複数のフィルタが実行される順序は、それらが登録または読み込まれる順序によって決まります。
   </p>
<p>
    <a class="link" href="variable.plugins.dir.html" title="$plugins_dir">プラグインディレクトリ</a>
    は、単一のパスを示す文字列または複数のパスを格納した配列でとなります。
    プラグインのインストールは、単にプラグインファイルをいずれかのプラグインディレクトリ内に置くだけです。
    そうすれば Smarty はそれを自動的に使用します。
   </p>
</div>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="template.resources.html">Prev</a> </td>
<td width="20%" align="center"><a accesskey="u" href="smarty.for.programmers.html">Up</a></td>
<td width="40%" align="right"> <a accesskey="n" href="plugins.naming.conventions.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">テンプレートリソース </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
<td width="40%" align="right" valign="top"> 命名規約</td>
</tr>
</table>
</div>
</body>
</html>
